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Preface 


This document explains how to use the network facilities available on the Sun 
Workstation. We assume that you have a fair amount of experience with the Sun 
Workstation, and the SunOS operating system. 

We provide examples so you can learn how to log in to and execute commands 
on remote machines, as well as to gain dialup access to a machine. However, we 
don’t present detailed explanations of the inner workings of the network pro¬ 
grams. As in each of the Beginner’s Guides, we refer to the other Sun documen¬ 
tation, drawing a road map for you to follow when you wish to learn more about 
a certain topic. 

In addition to explaining remote logins, remote command execution, and dialup 
access. Using the Network: Beginner’s Guide provides a command summary and 
glossary for easy access to the material. 

We suggest you read the Beginner’s Guides in the following order: 

Getting Started with SunOS: Beginner’s Guide 

SunView 1 Beginner’s Guide 

Mail and Messages: Beginner’s Guide 

Using the Network: Beginner’s Guide 

Setting Up Your SunOS Environment: Beginner’s Guide 

Doing More with SunOS: Beginner’s Guide 

Self-Help with Problems: Beginner’s Guide 

You will also find the following manuals to be useful: 


SunOS Reference Manual 
System and Network Administration 



Overview 
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NFS. 3 
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Overview 


Networks provide you with the opportunity to use other machines while logged 
in on your own machine. You can log in to other machines, or you can execute 
commands without logging in to other machines. 

1.1. What Is a Network? A network is a connection between machines, allowing them to transmit informa¬ 
tion to one another. Networks are often referred to as being local area networks 
(LANs), which range over a small area, generally less than a few thousand feet; 
wide area networks (WANs), which can span thousands of miles; or campus area 
networks (CANs), which are intermediate in size. 

Networks may themselves be groups of networks; such a super-network is called 
an internetwork. For example, you may be part of a network of machines on 
your building’s floor, and part of an internetwork cormecting your local network 
with similar networks across the country. As the difference between a network 
and an internetwork is generally invisible to the user, we wUl use the term "net¬ 
work" to refer to both networks and internetworks. 

Machines participating in a network communicate using a network protocol, or 
shared network language, to transmit the appropriate information to the right 
place. An internetwork protocol — sometimes referred to as a gateway or relay 
— links networks together. 

NFS If you are using a Sun Workstation, you are not necessarily on a network. You 

may, for example, bring you machine up single-user, or you may simply be on a 
machine which is not cormected to any network. 

Still, most Sun users are on a network of one sort or another. The Network File 
System, or NFS™, allows users on different machines to share files across a net¬ 
work.^ NFS is both a communications protocol — a set of rules machines follow 
for talking with each other— and a collection of software utilizing that protocol. 
NFS makes use of services provided by a network to allow for transparent transfer 
and access of files between machines; that is, NFS allows you to treat some files 
on other machines as though they were on your own machine. NFS was 
developed by Sun Microsystems and has been adopted by a number of other 
companies. 

^ NFS is a trademark of Sun Microsystems. 
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NFS is not limited to machines which nin SunOs; many other systems, from per¬ 
sonal computers to super-computers, can use it to share files across a network. 

NFS doesn’t exist on the netwoik — a netwoik is just a lifeless collection of 
wires, cables, phones, and other communications devices. Rather, each machine 
utilizing NFS runs its own set of the NFS daemons. (A daemon — sometimes 
known as a server^ — is a program which runs on your machine, doing various 
specific housekeeping chores. A printer daemon might handle the queueing up 
and printing of files, while a mail daemon takes care of sending messages back 
and forth between users. Most daemons are invisible to the user.) 

Traditionally, a multi-user system had a single processor (or set of processors) 
and disks serving a number of users: 

Figure 1-1 A Non-Network Environment 



The problem with the set-up in Figure 1-1 is that all the users are competing for 
the same processor. With a network of workstations, however, each user has his 
or her own central processor, and can access files located on other machines. NFS 
allows files to be scattered among the various machines on the network, so to the 
user the whole netwoik appears somewhat like one big computer: 


The word server has several definitions; see the glossary. 


»sun 

XT microsystems 
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Figure 1-2 A Typical Network Set-Up 



workstation! 



server 



printer 



A file system (aka filesystem) is the 
files and subdirectories, with their 
corresponding files, contained in a 
directory. For example, everything 
in /usr and its subdirectories 
makes up the /usr file system. 


Using NFS, you can get access to other machine’s files by mounting file systems 
on those machines. Chapter 3 gives an introduction to mounting remote file sys¬ 
tems; for a fuller discussion of NFS, see the Network Programming manual. On 
the Sun386i, mounting is done automatically, so you can skip this section. 


Types of Networks 


Some common networks you may encounter include: 

Local Area Networks 

As mentioned earlier, small networks are sometimes called Local Area Net¬ 
works (LANs). In local area networks, machines are connected by cables. 
Two types of LAN networks common to Sun machines are based on Ethernet 
and (soon) FDDI technologies; you may, for example, hear references to 
“sending something over the Ethernet.” Such networks allow real-time com¬ 
munication between machines, so you can log in directly to another machine 
and mn programs as though it were in front of you. You can also copy files 
to and from remote machines on a LAN. 


ARPANET-Based Networks 

In 1969 the Advanced Research Projects Agency (ARPA) of the U.S. Depart¬ 
ment of Defense sponsored the development of the a broadscale communica¬ 
tion network. Today there are a number of networks which use ARPANET 
technology; among the best-known and most-accessible is the Defense Data 
Network, which consists of two networks, the ARPANET and the MILNET. 
Beyond this is the Internet, which is a number of networks connected to the 
DDN using the Internet Protocols. 


Users on machines that attach directly to the network, by cables or 
microwave connections, can log in “real-time” to other machines on the 



microsystems 


Revision A of 9 May 1988 










Using the Network 


network. 

UUCP Network 

The UUCP network is not permanent system of hardware connecting 
machines, but a program which allows machines to use telephones to 
transmit data, thus creating a sort of ad hoc network each time the program 
is invoked. (People disagree whether on whether it should be considered a 
network at all.) You can use UUCP to communicate with machines across the 
United States and throughout the world. 

An ad hoc UUCP network is not a real-time network like a LAN network; in 
other words, you can’t log in to another machine using UUCP. However, you 
can send infonnation, like mail messages, to other machines and receive 
answers back from them. 

Because UUCP is not a real-time network, most of the information in this 
manual, such as logging in to remote machines, copying from other 
machines, and issuing commands to other machines, does not apply to it. 

For information about how to send and receive mail messages on the UUCP 
network, see Mail and Messages: Beginner’s Guide. 

People using machines on a UUCP network sometimes can send mail messages 
over ARPANET-based networks by utilizing a mail gateway, a machine that 
transfers data from one network to another.^ 

The Yellow Pages Because networks can get very large, doing system administration on them can 

get quite complicated: one needs to keep track of who belongs to a network, who 
has permissions to access which filesystems, and so on. For this reason. Sun pro¬ 
vides the Yellow Pages (YP). The YeUow Pages is a network database lookup 
service. That is, it maintains certain files with information about the machines 
which belong to the network and their users, and it provides users all over the 
network with the ability to look up the information contained in those files. By 
default there are a number of databases in the Yellow Pages, although a System 
Administrator may delete or add databases as desired (except on the Sun386i). 
These default databases include hosts, which has machine names along with 
their addresses on the network; passwd, which, like your local /etc/passwd 
file, contains password and other information associated with usernames; 
group, which holds the various groups that users have divided themselves into; 
and aliases, which contains mail aliases that the network recognizes. Not all 
systems mn the YP — ask your System Administrator if yours does.^ 

The Yellow Pages is a distributed database; that means that copies of its data 
files are kept in various places throughout the network, for faster access by users. 
(There is one central, master copy, and changes to it are propagated by YP down 
to the other “slave” copies.) The Yellow Pages lookup service revolves around 
two daemons: ypserv, which is the lookup function on the machine which has 

^ For infonnation about how to send and receive mail messages on ARPANET-based networics, see Mail and 
Messages: Beginner s Guide. 

^ All Sun386i systems run the YeUow Pages. 



Note: UUCP is an abbreviation for 
the UNIX to UNIX CoPy program that 
machines based on the Unix sys¬ 
tem, including Suns, employ to 
“talk” with each other. 
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a copy of the Yellow Pages, and ypbind, which lives on your machine and con¬ 
nects it to ypserv. In order to use the Yellow Pages database, these two dae¬ 
mons must be running. To find out if your machine is using the YeUow Pages, 
use the ps and grep commands; you should see something like this: 


f 


venus% ps -aux 

( grep ypbind 

root 27 0.0 

1.1 66 34 ? I 0:15 /usr/etc/ypbind 

venus% 



_y 


(You can use ps -aux to check for the presence of any daemon, including the 
NFS daemons.) 

You may never need to access the YP files; generally only System Administra¬ 
tors ever tinker with them. However, you may occasionally want to read these 
files. Some commands to help you include the following: 

ypcat 

This displays the YP data file you name. You can pipe it to the grep com¬ 
mand to find the entries you want. 

ypmatch 

ypmat ch looks up an entry, or "key," in a the YP database file you specify, 
ypwhich 

This command teUs you which YP server supplies Yellow Pages services for 
your machine. 

yppasswd 

You use yppasswd to change your network, as opposed to your machine’s, 
password. (Often they’re the same.) 

For further information on these commands, type man followed by the 
command’s name. For a fuller treatment of the Yellow Pages, type man 
ypf lies or consult the Network Programming manual. 
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Login Access to Other Machines 


2.1. Trust Amongst 
Machines on a 
Network 


/etc/hosts 


You can log in from your machine to another machine using one of these pro¬ 
grams: 

rlogin from one machine running an operating system based on 

the UNIX system (like SunOS) to another such machine 

telnet from one machine to another machine (which may have 

a different operating system) on a networic using the 
telnet Protocol. 

Additionally, Chapter 5 discusses tip, a program for establishing connections 
over phone lines, allowing you to log in to other machines. 

Some systems trust certain users and certain machines to log in without requiring 
a password and other security mechanisms. 


You can allow or restrict login access by other users to your machine. You, or 
your system administrator, can set up your machine so that users must supply a 
password to log in to your machine, or so that certain users from certain 
machines simply can’t log in to your machine. 

When another machine running the UNIX system^ on your local network trusts 
your username on your machine, that machine doesn’t require that you type your 
password or undergo other security checks to log in. The system files 
/etc/passwd and /etc/hosts . equiv control the users and the machines 
that may log in to your machine and to your account. 


Before we describe the files which control access privileges, let’s consider how 
one machine finds another over the network. The /etc/hosts file contains a 
list of machines — also known as hosts — and their corresponding addresses on 
the network. (The file can also contain any optional nicknames for machines.) 
Your own machine’s address is stored here. Programs use /etc/hosts to 
locate other machines for communicating over the network. 

However, if you’re running the Yellow Pages, the YP file hosts may supplant, 
or supplement, your own /etc/hosts file; the YP hosts contains the 


^ SunOS is an enhanced version of UNIX. 
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network addresses of every machine on the network.^ Therefore, you (or your 
System Administrator) need only maintain an up-to-date /etc/hosts file 
when the YeUow Pages are not available. 

Here is a sample /etc/hosts file: 

Figure 2-1 An /etc/hosts Fi/e 


( - 



# 



# Sun Host Database 


# 



# If the yellow pages is 

running, this file is only consulted when booting 

# 

127.0.0.1 

# 

localhost 

loghost 

192.9.90.114 

gaia 


192.9.90.103 

venus 




J 


/ etc/hosts . equiv The / etc/hosts . equiv file contains a list of machine names that your 

machine trusts. When a user on one of the machines in the list tries to log in or 
execute a command on your machine, your machine checks in your 
/etc/passwd file to see whether it should permit access, /etc/passwd 
regulates who can log in on a machine; it contains information about users, 
including their usernames, their passwords, their ID numbers, and so on.^ 

If that person’s username is in /etc/passwd, then your machine checks 
/ etc/hosts . equiv. If it contains the name of the machine that he or she is 
using, then your machine allows him or her to log in. If the username isn’t there, 
then he or she is prompted for a password. 

Here is a sample /etc/hosts . equiv file that permits any users on machines 
gaia, pluto, and verlaine (who also appear in your / etc/passwd file) 
to log in or execute commands on your machine from their machine. 

Figure 2-2 


Note: You must be root to modify 
this file. See Doing More with 
SunOS: Beginner’s Guide for informa¬ 
tion on becoming root. 


/etc/hosts . equiv File 

-s 

venus% cat /etc/hosts.equiv 

gaia ‘ 

pluto 

verlaine 

venus % 

_ > 


If your system supports the Yellow Pages, you may put a single plus sign (+) all 
by itself in your /etc/hosts . equiv file. This signals that anyone on the 
network served by the Yellow Pages (who is also named in /etc/passwd) 


* Not every system runs the Yellow Pages; not all that do use the hosts scheme. 

For more information about the /et c/pas swd file, see the chapter on processes and other users in Doing 
More with SunOS: Beginner’s Guide; see the SunOS Reference Manual; or type man 5 passwd. 
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may log in to your machine without providing a password. As a matter of fact, 
/etc/passwd also uses the plus sign convention, so you can thus allow every¬ 
one on the networic access to your machine. You can also selectively bar some 
people in the Yellow Pages database from logging in to your machine. 

You can further restrict other people’s access to your machine with the 
. rhost s file, located in your home directory. For more on . rhosts and 
/etc/host s . equiv, see the SunOS Reference Manual, the System and Net¬ 
work Administration manual, or type man hosts. equiv. 

2.2. Remote Login With rlogin logs you in to other UMX machines on a network, 

rlogin 

Logging In to Another Type rlogin and the machine name of the other machine. Should a password 

Machine With rlogin prompt appear, type your password for that machine followed by IRstumJ. If 

your machine’s name is in the other machine’s /etc/hosts . equiv file, then 
the other machine trusts your machine name and won’t require you to type your 
password. 

Figure 2-3 rlogin .• Logging In to Another Machine 



In Figure 2-3 user medici logged in to j up iter at the directory 
/home/medici, as indicated by the pwd command. When you log in to a 
machine where you don’t have a home directory, rlogin displays a 
notification that you have no home directory on that machine, and logs you in to 
the root directory (/) of that machine. 

Figure 2-4 rlogin; Logging In to a Machine Without a Home Directory 



rlogin to a Machine Where 
You Don’t Have a Home 
Directory 
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r login to a Machine As rlogin as we’ve described it above allows you to log in to another machine, 

Someone Else but under your own username. From time to time you may want to log in as 

someone else, so that you can fuUy manipulate files on the remote machine. One 
example of this would be when you’re off working on someone else’s machine 
(and using their username) and you want to log in to your own machine as your¬ 
self. The -1 option to rlogin allows you to do this. The format is as follows: 

rlogin machine-name -1 username 

For example, here’s how user medici on machine venus logs in on machine 
aphrodite as cosimo: 

Figure 2-5 rlogin.' Logging In to Another Machine With a Different Username 



Note that when you log in as someone else, you go to that person’s home direc¬ 
tory. 

rlogin to a Non-Existent If you attempt to log in to a machine whose name isn’t known to your machine. 

Machine say the machine andromeda, rlogin searches unsuccessfully through the 

hosts database for that machine, then displays the following notification: 

Figure 2-6 rlogin.' Logging In to a Non-Existent Machine 



If you see any error messages that you don’t understand, try looking at Table 4-1 
in Section 4.4, which contains solutions to common networking problems. 


To abort an rlogin connection, type a tilde character followed by a period 
character (~ .) at the beginning of a line. The login connection to the other 
machine aborts, and you find yourself back at your original machine. 

When you log in to a series of machines, accessing each machine through 
another machine, and you use ~ . to abort the connection to any of the machines 
in the series, you return to the machine where you started. 



Aborting an rlogin 
Connection 

Note: Usually you abort an rlo¬ 
gin connection only when you can’t 
terminate the connection using 
logout at the end of the work ses¬ 
sion. 


Revision A of 9 May 1988 





Chapter 2—Login Access to Other Machines 15 


Suspending an 
Connection 


Figure 2-7 

rlogin; Aborting a Connection 



Venus % rlogin comet. 

Last login: Thu Nov 21 05:04:03 from venus 

SunOS Release 4.0 (SUN) #9; Sat Nov 16 12:51:59 PST 1985 
comet % . {Sometimes "" doesn't echo,) 

Closed connection, 
venus % 

■n 


L _ 

J 


To disconnect to an intennediate r login, use two tildes For example: 


Figure 2-8 


Aborting to an Intermediate r 1 o g i n 


-s 

venus% rlogln comet 
comet% rlogin jupiter 

jupiter% , {Sometimes doesn’t echo.) 
comet% 

_ / 


rlogin When you want to suspend an rlogin connection, so that you can return to it 

later, type the tilde character f followed bv I Ctrl-Z I . The rlogin connection 
becomes a stopped process, and you are put back into the machine you logged in 
from. To reactivate the connection, type f g, or % followed by the job number 
of the stopped process (default job number for % is the job you most recently 
stopped or put in the background).^ 

Figure 2-9 rlogin.* Suspending a Connection 


r 


N 

venus% rlogin animation 



Last login: Thu Nov 21 

07:07:07 from venus 


SunOS Release 4.0 (SUN) 

#$: Sat Nov 16 13:21:24 PST 1985 


animation% 

(Sometimes "Z doesn’t echo on the screen.) 


Stopped 
venus % pwd 
/home/medici 
venus% % 
rlogin titan 

(Type ( Return 1 here to get the command prompt .) 


animation% logout 
Connection closed, 
venus% 

V. 


J 


As is the case with aborting rlogin with " ., using two tildes and a I Ctrl-Z 1 
will suspend you to an intermediate rlogin. 


* For more information on running jobs in the background, see the chapter on timesaving features in Getting 
Started with SunOS: Beginner’s Guide and the sectitxi on job ccmtrol in the chapter about the C shell in Doing 
More with SunOS: Beginner s Guide. 
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Verifying Your Identity with It can sometimes get difficult to remember just who and where you are. (Not just 
who am i in logging in to other machines. In life, too.) SunOS probably can’t help you 

much with the latter, but in the case where you have logged in to other machines, 
and perhaps logged in as someone else, and perhaps done so serially from remote 
identity to remote identity, we offer the following command: 


who am i 

who am i displays the machine you’re logged into, along with your current 
identity. (It also gives you the name of your terminal or workstation and the 
time.) Best of all, you can play pretty fast and loose with the syntax of this com¬ 
mand: 

Figure 2-10 Discovering Your True Identity 

- ^ . 

Venus % rlogin tripod -1 billyboy 

Password: 

Last login; Tue Nov 26 00:02:00 from portnoy 

SunOS 4.2 Release 4.0 (SUN) #9: Tue Nov 17 21:10:51 PST 1987 

tripod% who eats trash 

tripod!billyboy tty3 Nov 20 20:07 
tripod% logout 
Connection closed. 
venus% who killed sis 

Venus Imedici tty3 Nov 20 20:08 

venus% 

V_/ 


For further information about r login, see its Man Page, online or in the 
SunOS Reference Manual. 


2.3. Remote Login With 

telnet 


Because you can log in from one UNIX system machine to another such machine 
with rlogin, you need to use telnet only when you want to log in to a 
machine running another operating system.^ 

Therefore, telnet is most useful when your machine is on a network with 
machines that run other operating systems. 


Logging In to a Machine For example, to log in to machine t ops2 0, running the TOPS20^® operating sys- 

Running Another Operating tern, type telnet, followed by its mac/nVie name. After telnet notifies you 

System With telnet of the coimection with the other machine and identifies your escape character, 

try logging in to the machine as you ordinarily would. 


^ You may have to use telnet to log in to machines running varieties of the UNIX operating system that 
aren’t compatible with the current version of the Berkeley undc operating system (BSD). 

TOPS20 is a trademark of Digital Equipment Corporation. 
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Figure 2-11 telnet; Logging In to a Machine Running Another Operating System 



telnet to a Non-Existent If you attempt to log in to a machine that isn’t a part of your network, say the 

Machine machine andromeda, telnet searches unsuccessfully through the hosts 

database for that machine, then displays a notification to that effect and a prompt. 
Exit from telnet by typing quit, or the abbreviation q. 

Figure 2-12 telnet; Logging In to a Non-Existent Machine 



If you see any notifications that you don’t understand, look at the telnet Man 
Page, online or in the SunOS Reference Manual. 


Aborting a telnet 
Connection 

Note: Just as with rlogin, one 
aborts a telnet connection only 
when one can’t terminate the con¬ 
nection using logout at the end of 
the work session. 


When you want to abort a telnet connection, type the telnet escape char¬ 
acter (usually [ Ctrl-11 . press the I Ctrl I key and the close-bracket key simultane¬ 
ously), followed by quit to the telnet> prompt. The login connection to 
the other machine aborts, and you find yourself back at your original machine. 
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Suspending a 
Connection 


Figure 2-13 telnet; Aborting a Connection 


venus% telnet tops20 

Trying,.* 

Connected to tops20. 

Escape character is 


Yoyodyne Corp., TOPS-20 Monitor 6.1 (6762)-4 

@LOG MEDICI 


@ (Type [ Ctrl-1 1 to set telnet> prompt.) 

telnet> quit 

venus% 


V_ 

_y 


telnet When you want to suspend a telnet connection, so that you can return to it 

later, type the standard escape character (usually I Ctrl-1 h followed by z to the 
telnet> prompt. The telnet program becomes a background process. To 
reactivate the connection, type fg, or % followed by the job number of the 
background process (default job number for % is the job you most recently put in 
the background). 


The z command only works with the C shell (csh). For more information on running jobs in the 
background, see the chapter on timesaving features in Getting Started with SunOS: Beginner s Guide, and the 
section on job control in the chapter about the C shell in Doing More with SunOS: Beginner’s Guide, 



microsystems 


Revision A of 9 May 1988 




Chapter 2 — Login Access to Other Machines 19 


Figure 2-14 telnet; Suspending a Connection 

venus% telnet tops20 

Trying..• 

Connected to tops20. 

Escape character is 


Yoyodyne Corp*r TOPS-20 Monitor 6^1 <6762)^4 

0LOG MEDICI 


0 (Type [ Ctrl-1 1 to 2 et telnet> 

telnet> z 

Stopped 

venu s % % (Type {Return] twice to get command prompt of other system.) 

telnet tops20 

0logout 

Connection closed by foreign host. 
venus% 

< _ > 


For further information about telnet, see its Man Page, online or in the 
SunOS Reference Manual 
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Mounting Remote Filesystems 


You may very often find that you have a need to access programs which are 
located on another machine. Many times it is not practical, because of space lim¬ 
itations, to copy the files you need over to your machine. For this reason, NFS 
(described in Chapter 1) offers you the ability to mount other filesystems, allow¬ 
ing you to access files on other machines as though they were on your own. 

For example, if your company had a lot of software which everyone used, such as 
spreadsheets, demos, and text editors, a lot of valuable storage space would be 
taken up if each user had to have his or her own copies of all the programs. Peo¬ 
ple could use rlogin to access other machines, but this would be unsatisfactory 
if they had to do so every time they wanted to run a program. What your com¬ 
pany could do, though, would be to put the relevant files on one host (also known 
as a server) and have users mount the filesystem containing those files. 

Sun386i users can overlook this material, because, on Sun386i systems, the auto¬ 
mounter (described in Section 3.4) automatically mounts required filesystems for 
the user. 

3.1. The mount Suppose your company’s demos are located in /usr/demos on a server caUed 

Command slugf e st. You create (or have your System Administrator create) a directory, 

/usr/demos, on your own system. This /usr/demos is called a woMrtt 
point', you then use the mount command to create a sort of invisible connection 
between /usr/demos on slugfest and your /usr/demos mount point. 

As long as you maintain the mounting, every time you refer to /usr/demos, 
you access the one on slugfest. You access slugfest’s /usr/demos as 
though it were on your own machine — you can list its contents with Is, cd in 
and out of it, view its files with more, run its programs, and so on. Mounting 
allows you to do all of this without having to rlogin in to slugfest. 

Use the mount command to mount other filesystems. The general format of the 
command is 

mount machine-name:filesystem directory 

where machine-name is the name of the remote machine which contains the 
filesystem you want to access; filesystem is that remote filesystem; and directory 
is a directory on your system. (It is, in fact, the mount point). Here’s how you 
would mount /usr/demos and view its contents: 


Note: You must be root to use 
mount. See Doing More with 
SunOS: Beginner’s Guide for informa¬ 
tion on becx5ming root. 
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Figure 3-1 Mounting Remote Filesystems 


r 



> 

venus# mount 

slugfest;/usr/demos 

/usr/demos 


venus# Is /usr/demos 



Readme.goban 

canvas_demo 

globeframes 


SRC 

cursor demo 

jumpdemo 


bouncedemo 

f ramedemo 

spheresdemo 


venus# 




\_ 



_ j 


You do not have to mount a remote filesystem to a filesystem of the same path¬ 
name. In other words, you don’t have to mount /usr/demos on slugf est to 
a directory called /usr/demos on your machine. You can mount it to any 
directory you want. In fact, since most users aren’t allowed to create directories 
in /usr, you could, for example, create a subdirectory dem in your home direc¬ 
tory and mount /usr/demos there (assume /home/art/medici is your 
home directory): 


Figure 3-2 Mounting to A Different Directory 


Use su to become root. 


f - 

venus% mkdir 

/home/art/medici/dem 


A 

venus% su 




Password: 

(Type root ’ s password here.) 


venus# mount 

slugfest:/usr/demos 

/home / art /medici /dem 


venus# 

(Type ( CtrUD ) to stop being root > 


venus% Is /home/art/medici/dem 



Readme♦goban 

canvas_demo 

globeframes 


SRC 

cursor^demo 

jumpdemo 


bouncedemo 

f ramedemo 

spheresdemo 


venus% 

V 





The important thing is that you make sure that there’s a mount point on your sys¬ 
tem to mount the remote filesystem to. Suppose you try to mount /usr/demos 
to a directory, /usr/showme, without creating /usr/showme first. You’ll 
get an error like this: 


Figure 3-3 Mounting to a Nonexistent Directory 

( ) 

venus# mount slugfest:/usr/demos /usr/shovime 

mount: slugfest:/usr/demos on /usr/showme: no such 

file or directory 

mount: giving up on /usr/showme 

venus# 

.. . . . . . 


3.2. The /etc/fstab 

File 

Note: you must be root to modify 
your /etc/fstab file. 


Rather than having to use mount for every filesystem you want to mount, you 
can make use of the file f stab which is located in the directory /etc}^ 


fstab stands for “file system table.” 
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f Stab is a table of filesystems you want to mount, with any filesystem options 
you want Every time your system is booted, it checks f stab to see what 
filesystems to mount. This can save you considerable time over using the 
mount command directly for each filesystem you want mounted. 

The general format of an entry in an f s t ab file is 

machine :filesystem directory type option freq pass 


where 

machine :filesy stem 

is the remote filesystem you want to mount and the machine on which it is 
located 

directory 

is the directory on your system you want to mount it to 

type 

is the filesystem type, in this case nfs 
options 

are the filesystem options, such as those described in Section 3.3 

freq 

is the number of days between dumps 

pass 

partition check pass number 
Here’s an example of an /etc/f stab file: 

Figure 3-4 A Sample fst ah File 


/- 

dirt:/export/root/venus 

/ 

nfs 

rw 

0 

0 

dirt:/usr 

/usr 

nfs 

ro 

0 

0 

dirt:/home/dirt 

/home/dirt 

nfs 

rw 

0 

0 

moon:/usr/spool/news 

/usr/spool/news 

nfs 

ro,soft,bg,intr 

0 

0 

anchor:/usr/games 

/usr/games 

nfs 

ro,soft,bg,intr 

0 

0 

boodle:/usr/boodle 

/usr/boodle 

nfs 

ro,soft,bg,intr 

0 

0 

boodle:/usr/man 

/usr/man 

nfs 

ro,soft,bg,intr 

0 

0 

boodle:/usr/tools 

/usr/doctools 

nfs 

rw,hard,bg,intr 

0 

0 

capulet:/usr/demo 

/usr/demo 

nfs 

ro,soft,bg,intr 

0 

0 

Olympia:/usr/doc 

/usr/doc 

nfs 

ro,hard,bg,intr 

0 

0 

Olympia:/usr/olympia 

/usr/olympia 

nfs 

rw,hard,bg,intr 

0 

0 

buoy:/usr/buoy 

/usr/buoy 

nfs 

rw,hard 

0 

0 

yow:/usr/src 

/usr/src 

nfs,ro,soft,bg,intr 

0 

0 


The umount Command umount unmounts file systems which you have previously mounted, umount 

works similarly to mount; however, you only need to specify the mount point on 
your system when using it. You do not need to mention the remote machine it’s 
mounted from. So, for example, to unmount /usr/demos, which we mounted 
in Figure 3-1, you would type as follows: 
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Figure 3-5 Unmounting a Filesystem 


r 


venus# umount /usr/demos 


venus# 



_ V 


As with mount, you must be root to use umount. 


There are various ways to use mount and umount. A few of the more com¬ 
mon ways are given here. Please note that you can combine a number of these 
options: for the exact syntax, consult the SunOS Reference Manual or type man 

mount. 

(with no options) 

mount with no arguments displays what you currently have mounted. You 
do not have to be root to use the mount command this way. 

-p (“Print”) mount displays a list of mounted filesystems in the format used 
in fstab. You don’t need to be root to use mount this way, either. 

-V (“Verbose.”) Displays a message indicating each filesystem in 

/etc/f stab being mounted as it occurs. This option is also available 
with umount. 

-a (“All.”) mount will attempt to mount aU the filesystems in 
/etc/f stab. 

filesystem 

or 

directory 

If you use mount with either the name of a filesystem to be mounted or 
the name of one of your directories to mount to (but not both), mount 
searches fstab for the corresponding entry and mounts the filesystem as 
indicated therein. Also tme for umount. 

-h host 

(This is a umount option.) umount unmounts all the filesystems which 
are remote-mounted from the server host. In Figure 3-4 there are a number 
of filesystems mounted from the server boodle', to unmount them, you would 
give a command like this: 

Figure 3-6 Unmounting Selected Filesystems 

- 

venus# TJinount -v -h boodle 
/usr/man: Unmounted 
/usr/boodle: Unmounted 
/usr/tools: Unmounted 
venus # 

V___ J 

Filesystem Options -o options 

There are a number ofto mount. These affect the access 


3.3. Options to mount and 
umount 
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you have to the remote filesystem, and the manner that mount goes about 
trying to mount the system. These are some of the more common filesystem 
options: 

hard or soft 

If you soft-mount a remote filesystem, mount will try up to a certain 
number of times, and then give up, returning you an error message; 
when you hard-mount it, mount will continue trying the mount until it 
is successful. 

There are advantages to both hard- and soft-mounting. Hard-mounting 
ensures that mount wiU not give up on a server which is only tem¬ 
porarily inaccessible, but wiU eventually connect you. It is a good idea 
to always hard-mount filesystems which you write to; that way you 
lessen the chance of data being lost during a write operation. On the 
other hand, if you are hard-mounted to a server which crashes, your sys¬ 
tem may hang up while waiting to connect with the remote server. 

hqor fg 

You can specify whether you want mount to retry failed mounting 
attempts in the background or \ht foreground. When a mount occurs in 
the foreground, the shell is tied up until the mount succeeds; if you run 
the mount in the background, the shell and you can do other things dur¬ 
ing the mount attempt. 

rw or ro 

You can mount the other filesystem as read-write or read-only. It is a 
good idea to mount other systems as ro if you are only going to access 
their files and programs, not write or change them. 

intr 

If you hard-mount a filesystem, intr allows you to interrupt the moimt 
from the keyboard (with I Ctrl-C 1 1. 

For information on other filesystem options, see the SunOS Reference 
Manual. 

Remember, you can combine various options when using the mount command 
— see the SunOS R^erence Manual. 

3.4. The Automounter Just as the mount command lessens the need to rlogin in to another machine 

every time you want to access its files, the automounter lessens the need for 
hand-mounting remote systems. The automounter mounts remote file systems 
“on the fly”; that is, it creates a temporary mount point in /tmp_mnt for you, 
mounts the remote system, and unmounts it automatically. It does so without 
your having to change your f stab file. In fact, you do not need to become 
root to dynamically mount and unmount remote filesystems. 

The mounting takes place invisibly when you refer to the remote filesystem is a 
unique way. Thus, you can cd to a remote directory. Is its contents, more a 
file on another machine, and so on, all without having to mount anything first 
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The automounter finds the remote machine and filesystem by using either a file 
on your machine or a Yellow Pages map. The syntax for using the automounter 
can vary from site to site, or machine to machine. Here is a general example of 
how it is used:^"^ 

Suppose your site uses the YeUow Pages hosts and passwd databases. These 
contain the addresses of machines on the network, and the list of users and their 
home directories, respectively. First, you would start the automounter daemon 
with a command line similar to this: 

Figure 3-7 Starting the Automounter 

You must be root to start Xhs auto¬ 
mounter. Many people have the 
automount daemon start up when 
they boot their system, by modifying 
their /etc/rc.local file Consult 
your System Administrator. Now a reference to / net /machine/filesystem wiU cause the automounter to 

automatically mount filesystem from the machine machine. For example, in Fig¬ 
ure 3-8, the command Is /net/ jupiter/var/spool causes the auto- 
moimter to mount /var/spool from the machine jupiter, and Is lists its 
contents: 

Figure 3-8 Using the Automounter: I 




Likewise, a reference to /homes /username causes the automounter to mount 
the home directory of the person with the username username. Using this syntax, 
cat displays the contents of the file rhyme . file in bcleaver’s home direc¬ 
tory: 

Figure 3-9 Using the Automounter: II 



Because each site running NFS is unique, consult your System Administrator on how to use the 
automounter. 
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If you go a specified period (usually five minutes) without accessing the remote 
filesystem, automount unmounts it for you. 

For more information on using the automounter, type man automount. 

3.5. Who’s Mounting This The showmount command gives the opposite information from typing 

System? showmount mount. It gives information about who has mounted filesystems from a particu¬ 
lar server. 

For example, let’s assume that user michael on the machine yazoo has 
mounted /usr/games from the server slugfest; reed on zippy has 
mounted /usr/demos from the same server, and roger, on yow, has 
mounted /usr/tools. 

The -a option displays all the remote mounts in the form hostname:directory. 
Figure 3-10 showmount -a 
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Issuing Commands to Remote Machines 


Your Sun Woricstation supports many programs that execute commands on other 
machines while you are logged in on your own machine. You can use these pro¬ 
grams to: 

o Obtain status information (rup, ping, and perfmeter) 

□ List user information (rusers and finger) 

□ Copy files or directories (rep and ftp) 

□ Execute commands (r sh) 

In addition to describing these functions, this chapter provides examples of error 
notifications common to network use, and solutions for, or explanations of the 
problems they represent. 

4.1. Status Information: ping, rup, and perfmeter provide m/ormanon for other machines, 

ping, rup, and 
perfmeter 

Dead or Alive: ping ping checks to see if another machine is up and running or not. ping is useful 

because it’s a quick way to determine the status of another machine before you 
try to access it, or if you’re having trouble accessing it. The ping command 
takes the form 

ping host timeout 

where host is the machine you’re testing, timeout is an optional amount of time 
you want ping to try for. If you don’t include n/neowr, ping will try for 20 
seconds, or until it gets an answer. 

Figure 4-1 Using ping 
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Remote Uptime: rup To find out the length of time a system has been ‘ ‘up and running,’ ’ and to view 

its load average, type rup followed by the machine name of the desired 
machine. 


Figure 4-2 rup; Uptime and Load Average for a Specific Machine 


Note: rup stands for remote 
uptime, a version of the uptime 
command that runs uptime on 
other machines. 


r 



.\ 

venus% rup pluto 




plutQ up 1 day. 

5:47, 

load average: 3.64, 3,53, 2.80 


venus% 




V 



J 


To get the same set of information for all of the machines that are “up and mn- 
ning’ ’ and on your local network, type rup without any arguments: 


Figure 4-3 rup; Uptime and Load Average for the Machines on Your Ethernet 

venus% rup 


mercury 

up 

1 day. 

23:31, 

load 

average: 

0.04, 

0.00, 

o 

Q 

O 

venus 

^ up 

8 days. 

21:27, 

load 

average: 

0.26, 

0,13, 

0.02 

earth 

up 

3 days,. 

20:44, 

load 

average: 

1.07, 

0.90, 

0.54 

mars 

up 


36 mins. 

load 

average; 

r-4 

O 

O 

0.00, 

0.00 

jupiter 

up 


20:30, 

load 

average: 

0.52, 

0.20, 

0.05 

Saturn 

up 

B days. 

18:29, 

load 

average: 

1.27, 

1,12, 

1.00 

neptune 

up 

2 days. 

00 

CM 

load 

average: 

2.27, 

1,73, 

1.18 

uranus 

up 

1 day^ 

3:19, 

load 

average: 

0.64, 

0.90, 

1.04 

pluto 

up 

1 day. 

S:47, 

load 

average: 

3.64, 

3.53, 

2.80 


venus% 

To find out more, see the rup Man Page, online or in the SunOS Reference 
Manual. 


Performance Meter: 

perfmeter 

Note; You can only use perime¬ 
ter when running SunView, Sun’s 
window system. 


perfmeter gives a visual readout of the status of a machine — yours or some¬ 
one else’s. It can tell you how busy someone is; for example, if a machine seems 
to be inactive, its owner may be away from his or her desk. Here’s how a user 
might run perfmeter; 


Figure 4-4 


perfmeter 



In Figure 4-4, the user has five versions of perfmeter mnning. The three on 
the left give the user information about his or her own machine: the one labeled 
cpu shows how much of the machine’s central processor is being used; pkts 
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indicates how much information is going over the networic; and load shows the 
average number of runnable processes in the last minute. The perf meter 
display second from right show the central processor activity for the remote 
machine bird, while the little tombstone figure on the far right shows that 
machine dalkey is not running, perimeter displays other useful informa¬ 
tion; to find out more about it, see the SunView 1 Beginner’s Guide, and the 
perimeter Man Page, online or in the SunOS Reference Manual. 


Remote User Information 
With rusers 


Figure 4-5 


Note: rusers stands for remote 
users, a version of the users com¬ 
mand that runs users on other 
machines. 


rusers tells you who’s logged on to other machines on your network. The 
command rusers by itself shows each machine on the network, followed by 
the users on that machine: 


rusers 


r 




A 

venus% rusers 





homeplate 

billyb 




absalom 

john 




babyIon 

manchild 




garden 

rusaell 

cousy 

havilcek 


texas 

houston 




venus% 





\_ 




j 


Note in Figure 4-5 that machine garden has three different users on it. 

If you wanted information on just one machine, you would type rusers fol¬ 
lowed by the machine’s name: 


Figure 4-6 


rusers for a Specific Machine 


venus% rusers garden 

garden russell cousy havilcek 

venus% 

S.___ / 


For more detailed information, there’s the -1 option, which gives the username, 
the machine and terminal names, the time the user logged on, how long the 
users’s been idle (if more than one minute), and the name of a machine that the 
user rlogged in from, if any: 


Figure 4-7 


rusers; Detailed Information 

* —-- 

venus% rusers -1 garden 


russell 

gardenittydS 

Nov 

18 

09:00 

7:24 

cousy 

garden;console 

Nov 

18 

16:13 


havilcek 

garden:ttypd 

Nov 

18 

11:43 

21 (quirk) 


venus% 
<_ 


The -1 option can also be used when no machine name is given, as in Figure 4- 
5. For more information, see the rusers Man Page, online or in the SunOS 
Reference Manual. 
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The finger Command rusers is a good way of getting some information about who’s logged in on 

other machines. The finger command, though, really gives you the lowdown 
on other users. In fact, unlike commands such as ping or rusers, finger 
doesn’t give you information about other machines. It teUs you only about other 
users. In fact, finger is so user-oriented that it accepts people’s real names, as 
well as their usernames, as arguments. 

Here’s what finger teUs you: 

□ the user’s login name 

□ his or her real name 

□ his or her home directory and login shell 

□ the last time he or she logged in 

□ the last time he or she received mail, and the last time he or she read it 

□ the name of his or her terminal(s), and how long it’s been idle 

Here is a slightly simplified example of a two typical finger requests. Your 
output may vary somewhat. 

Figure 4-8 finger 

Venus % finger moby@«ea 

[sea] 

Login name: moby In real life: Ishmael Wong 

Directory: /home/shipwreck/moby Shell: /bin/csh 

On since Nov 14 06:33:41 on console 4 days 14 hours Idle Time 
New mail received Wed Nov 18 20:34:02 1987; 

unread since Wed Nov 18 16:20:24 1987 
venus% finger Henry Stamper 

Login name: hank In real life: Henry Stamper, Jr 

Directory: /home/oregon/hank Shell: /bin/csh 

Last login Wed Oct 21 16:16 on ttypO from cairo 
No unread mail 

V_^_> 

finger is useful for making sure that the user you’re looking for is still alive 
and kicking (computer-wise, anyway), finger has various options and further 
capacities; to learn about them, see the SunOS Reference Manual, or type man 

finger. 

To copy files from another machine onto your machine, or copy files from your 
machine onto another machine, use one of the remote file copy commands. Each 
program has a slightly different specialty for file copying: 

rep Most common, but only between UNIX system-based machines ; permits 
copying of entire directories 

ftp uses a standard, generalized protocol 


4.2. Remote File Copy 
With rep and ftp 

Note: If you have a filesystem on 
another machine mourned, you do 
not have to use remote copy com¬ 
mands to put and get files in that 
filesystem. See Chapter 3. 
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Copying from Another To remote copy a file from another machine onto your machine with rep, use 

Machine to Your Machine the following syntax: 

Using rep 

rep machinename.'file directory 

where machinename is the name of the machine you want to copy from; file is 
the file you want to copy; and directory is where you want to put the file on your 
system. 

For example, to copy a file called /home/eharon/new. toy from the 
machine called pluto to the directory called /home/mediei/toys on 
your machine, venus: 

Figure 4-9 rep.* Copying from Another Machine to Your Machine 

venus% rep pluto:/home/charon/new.toy /home/mediei/toys 

venus% 


You can use normal SunOS shorthand for directories (such as ~ for your home 
directory and . for the current directory). When you want to call the file by a 
different name on your own machine, specify a destination filename at the end of 
the destination directory on your machine. For example, here’s how you could 
copy the file new. toy from machine pluto to your home directory and 
rename it my. toy: 

Figure 4-10 Copying and Renaming with rep 

- 

venus% rep pluto:/home/charon/new.toy "'/my.toy 

venus% 

\ 


If rep displays an error notification, see the section on error notifications (Sec¬ 
tion 4.4). 


Copying from Your Machine To rep a file from your machine onto another machine, you reverse the syntax 
to Another Machine Using above: 

rep 

rep file machinename’.directory 


where file is the file on your machine you want to copy; machinename is the 
machine you want to copy to; and directory is the place you want to send the file 
to. 

For example, to copy a file called /home/mediei/old. toy from your 
machine to the directory called /home/eharon/trash on the machine 


For a description of these naming conventions, see the Doing More with SunOS: Beginner s Guide. 



microsystems 


Revision A of 9 May 1988 





38 Using the Network 


pluto : 

Figure 4-11 rep; Copying from Your Machine to Another Machine 

/ \ 

venus% rep /home/medici/old.toy pluto:/hone/eharon/trash 

Venus% 

V___/ 


When you want to call the file by a different name on the other machine, specify 
a destination file at the end of the destination directory on that machine, as in 
Figure 4-10. 

If rep displays an error notification, see the section on error notifications (Sec¬ 
tion 4.4). 


Copying Directories With 

rep 


Warning: copying directories with 
rep doesn’t preserve permission 
and ownership settings. 


To copy a directory and its contents from another machine to your machine, or 
vice verra, use rep with the -r option. Then, follow the steps for copying 
files, only replace the filenames with the appropriate directory names. 

To copy a directory and its contents from another machine to your machine, type: 

rep -r machine-name'.directory local-directory 


(Where machine-name is the name of the remote machine; directory is the direc¬ 
tory on that machine that you want to copy; and local-directory is the directory 
on your machine you want to copy to.) 

To copy a directory and its contents from your machine to another machine, type: 


rep -r local-directory machine-name'.directory 


(Where local-directory is the directory on your machine you want to copy and 
directory is the place on the other machine you want to copy to.) 

Like rlogin, rep uses the other machine’s /ete/hosts . equiv and 
/ete/passwd files to determine if you have unchallenged access. 


Copying from Another To copy a file from a machine that isn’t necessarily running a version of UNIX 

Machine to Your Machine operating system, use ftp, the file transfer program. Here are the steps for 

Using ftp copying a file from another machine to your machine using ftp: 

□ Type ftp to start the program. 

□ When you see the ftp> prompt, type open followed by the mac/ime 
name of the other machine. 

□ Wait for ftp to establish a connection. 

□ Type your username on the other machine to the Name prompt 

□ Type your password on the other machine to the Password prompt. 
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□ Wait for ftp to log you in to the other machine. 

□ When you see the ftp> prompt, type get, followed by the(use 
absolute pathname) of the file on the other machine, and the destination 
filename (absolute pathname) where you want the file to appear. 

□ When ftp notifies you that the transfer is complete, type quit to close the 
network connection. 

Figure 4-12 f t p; Copying from Another Machine to Your Machine 

-^-N 

V€nUS% ftp 

ftp> open pluto 

Connected to pluto* 

220 titan FTP server (Version 4.125 Sat Nov 2 13:01:21 PST 1985) ready 

Name ^plutotmedici) : medici _ 

Password (pluto: med i c i) : (Type password followed by ( Return ] .) 

331 Password required for medici, 

230 User medici logged in. 

ftp> get /home/medici/new.toy /home/medici/toys 

200 PORT command okay. 

150 Opening data connection for /home/medici/new.toy , . . (176 bytes) 
226 Transfer complete. 

183 bytes received in 0.01 seconds (9.4 Kbytes/s) 

ftp> quit 
venus% 

I_. 


Copying from Your Machine 
to Another Machine Using 

ftp 


Here are the steps for copying a file from your machine to another machine using 

ftp; 

□ Type ftp to start the program. 

□ When you see the f tp> prompt, type open followed by the machine 
name of the other machine. 

□ Wait for ftp to establish a connection. 

o Type your username on the other machine to the Name prompt. 

□ Type your password on the other machine to the Pas sword prompt. 

□ Wait for ftp to log you in to the other machine. 

□ When you see the ftp> prompt, type send, followed by the/i/enawe 
(use absolute pathname) of the file on your machine, and the destination 
filename (absolute pathname) where you want the file to appear on the other 
machine. 

o When ftp notifies you that the transfer is complete, type quit to close 
the network connection. 
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Figure 4-13 ftp; Copying from Your Machine to Another Machine 

venus% ftp 
ftp> open pluto 

Connected to pluto. 

220 titan PTP server (Version 4.125 Sat Nov 2 13:01:21 PST 1985} ready, 
Name (pluto:medici): medlci 

Password (pluto;medici) : (Type password followed bv (Return ] .) 

331 Password required for medici. 

230 User medici logged in. 

ftp> send /home/medici/old,toy /home/medici/trash 

20Q PORT command okay* 

150 Opening data connection for /home/medici/old.toy * * . (176 bytes) 

226 Transfer complete, 

183 bytes received in 0.01 seconds (9*4 Kbytes/s) 

ftp> quit 
venus% 

- J 

quit to close the network connection. 

Further Information For more information on rep or ftp, see their Man Pages, online or in the 

SunOS R^erence Manual. 


4.3. Remote Command 
Execution With rsh 

Note: rsh stands for remote shell, 
or an interpreter capable of execut¬ 
ing commands on another machine. 


rsh aUows you to execute a single command on another machine without hav¬ 
ing to formally log in. It can save time when you know you only want to do one 
thing on the remote machine. 

To execute a command on another machine, type rsh followed by the 
machine’s name and the command. For example, suppose you want to see the 
contents of the directory /home/fresno/crops on the machine fresno: 


Figure 4-14 Executing a Command on Another Machine 


Venus% 

rsh fresno Is 

/home/fresno/crops 


corn 

kiwi 

oranges 


grapes 

olives 

peaches 


venus% 

\_ 



j 


When you execute a command on another machines using rsh, rsh doesn’t 
log in; it talks to a daemon that executes the command on the other machine. 
However, if you have a . c shr c file in your home directory on the other 
machine, rsh reads it. So rsh uses any pertinent aliases that you have defined 
on the other machine when executing the command. 

Like rlogin and rep, rsh uses the other machine’s /etc/hosts . equiv 
and /etc/passwd files to determine whether you have unchallenged access 
privileges. 

For more information, see the rsh Man Page, online or in the SunOS Reference 
Manual. 
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4.4. Network Error 
Notifications 


This section provides a table of network error notifications and possible solutions 
for, or explanations or the problems associated with each error notification. 
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Table 4-1 Network Error Notifications: Problems and Solutions 


Error Notification 

Problem 

Address already in use. 

Other machine is down or 
not functional 

Connection refused. 

The other machine is up, but 
its daemons aren’t ready to 
complete a connection. 

Connection timed out. 

One machine or the other is off, 
hung (stuck), or down 

File not found. 

File doesn’t exist on other 
machine. 

Host name for your address 
unknown. 

Other machine needs your 
machine name in its 
/etc/hosts file 

Login incorrect. 

You mistyped a password, or your 

username isn’t in the 

other machine’s /etc/passwd 

Network is unreachable. 

Routing problem — 
a gateway machine or other 
network connection is broken 

...No such file or directory 

File or directory on other 
machine doesn’t exist, or 
you don’t have read permission. 

. . . not found. 

Directory on other machine doesn’t exist 

Nothing at all 

Directory on other machine is empty 

Permission denied. 

Machine name isn’t in 
/etc/hosts . equiv file; password 
required; may need write permission 
for directory on your machine 

RP C_PMAP__F AI LURE 

Daemon not running properly 

RPC_TIMED_OUT 

Couldn’t connect to other machine, 
it may be down 

RPC_UNKNOWNHOST 

Machine name doesn’t exist on network 

unknown host 

Other machine name not in 
/etc/host s file on your machine. 
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Using Dialup Terminals 


Note: A terminal may be a process 
running on a machine, running 
without any association to the piece 
of hardware usually considered a 
terminal. 


This chapter describes how to establish a dialup connection from a terminal, per¬ 
sonal computer, or workstation to another machine. Because of the great variety 
of equipment involved, it is not possible to describe the process in complete 
detail, so general guidelines appear here. It also gives an introduction to the 
SunOS program tip, for establishing telephone connections between machines. 

When you wish to establish a dialup connection from a machine that supports 
tip or cu to another machine, see the section on tip (Section 5.4) or the Man 
Pages, online or in the SunOS Reference Manual. 


5.1. Equipment You need two pieces of equipment to initiate a dialup connection: 

□ a terminal, workstation, or personal computer 

□ a modem (and telephone lines!) 

A hardware terminal is a keyboard and screen device that has no real CPU, or 
central processing unit, so for the most part it doesn’t support general computa¬ 
tion or programs. However, to establish a dialup connection to a machine, the 
computation ability available on a workstation or personal computer isn’t neces¬ 
sary. 

The modem is a device that permits you to transmit computer signals from your 
terminal, workstation, or personal computer through a phone line to another such 
device that translates the signals so they are again accessible by a user at the des¬ 
tination machine. 


5 .2. Considerations 


Many considerations may affect your attempt to connect to a machine by dialup 
access, such as: 

□ Interpretation of I Return I and I Line Feed I 

□ Xon/Xoff protocol 

o Parity (odd, even, or no parity) 

□ 7-bit transmission versus 8-bit transmission 


Besides pointing out that the destination machine must have a modem to inter¬ 
pret the signals transmitted by your modem, this manual attempts to explain only 
a few details about two considerations that are especially important: the phone 
number and the baud rate. 
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Phone Number To dial up the other machine, you have to know its phone number — ask some¬ 

one you know or contact that machine’s system administrator. Of course, some 
machines don’t support dialup connections. 


Baud Rate The baud rate is the rate at which your terminal, workstation, or personal com¬ 

puter exchanges data (usually bits per second) with the machine you’re access¬ 
ing. The two most common baud rates for dialup connections are 300 baud and 
1200 baud. Both sides of the connection must transmit and receive at the same 
baud rate or they’ll get “confused.”^^ 

Some machines set or adjust baud rates automatically. But if gobbledegook 
appears on your screen when you establish a connection to the other machine, it 
probably means that you need to adjust your baud rates for sending and receiving 
data. See the terminal, workstation, or personal computer manual to learn how to 
do so. 


5.3. The Process To dial up from your terminal, workstation, or personal computer to a machine, 

follow these steps: 

n Power on your terminal, workstation, or personal computer and your modem 

□ Dial up the other machine by typing the appropriate commands from your 
keyboard to your modem (read the instruction manual for your modem!) 

□ Connect to the other machine (sometimes you have to type I Return 1 once or 
twice to establish the connection) 

□ Log in to the other machine 

□ Complete your work session 

□ Log out from the other machine 

□ Disconnect from the other machine (sometimes you have to type an escape 
character to regain the attention of the modem) 

□ Power off your terminal, workstation, or personal computer and the modem 
(unless you use them continuously). 


5.4. Remote Login With You can use tip to log in to machines that aren’t on your local network, but are 

Note:^upan interface to tip accessible by dialing up. t ip, the terminal interface processor, lets you dial up 

based on what was originally a UNIX other machines and establish a modem connection. 

Version 7 command, is available. 

See its Man Page if you want to 
know more about it. 


A bit of trivia: the word baud originates from the name Baudot, the person who invented the Baudot 

Code. 
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Establishing a Connection To establish a t ip connection, type t ip followed by the phone number of the 

With tip machine to which you want to connect. 

Figure 5-1 tip; Establishing a Connection 



Problems Establishing a tip may fail to make a connection for one of several reasons. When the phone 

Connection With tip line is busy or doesn’t answer, tip prints the message call failed. Check 

the phone number and try again. If the problem persists, try looking at the t ip 
Man Page, online or in the SunOS Reference Manual. 

Figure 5-2 tip; Call Fails 



Sometimes the system at the other end of the phone line may not respond prop¬ 
erly. Perhaps it is down temporarily or has some kind of maintenance problem. 
Contact a user on the other system, or its system administrator, to correct the 
problem. 

When the local machine is loaded with many processes, tip may not be able to 
synchronize with a modem to connect with the other machine. Try again, and if 
that doesn’t work, wait until the system is less loaded. 

Figure 5-3 tip; Synchronization Problem 
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Command Summary 


This is a summary of all commands mentioned in this manual. Each command 
appears in alphabetical order by name, and includes a syntax diagram, and a brief 
paragraph describing its function. 

finger finger «amc 

Gives information about the user named by name, name can be a 

person’s username or real name. 

ftp ftp 

File transfer program that includes commands: 

get get filename local-filename 

Transfer file filename from the machine to which a con¬ 
nection is open to this machine and call it local-filename. 

open open machine-name 

Establish a connection to machine-name. 

quit quit 

Quit ftp. 

send send local-filename filename 

Transfer file local-filename from this machine to become 
file filename on the machine to which a connection is 
open. 

mount mount 

Display all moxmted filesystems. 

mount machine-name .filesystem directory 

Mount the specified filesystem filesystem on machine machine-name 

to directory directory. 


mount options 

-a Mount aU filesystems in/etc/f stab. 

-p Print aU mounted filesystems in a format 

useful to /etc/f stab. 
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-V Display mounts as they occur. 

-ooption Mount the filesystem according to option. 

Valid options include bg/fg (background 
vs. foreground); ro/rw (read-only vs. 
read-write); hard/soft (retry on error or 
not). 

mount \filesystem 1 directory] 

Mount the remote filesystem filesystem to directory as indicated in 
/etc/fstab. 

perimeter 

perimeter [machine-name] 

Provides status information window for this machine or the machine 
specified by machine-name. Runs under SunView. 

ping ping machine-name 

Tells whether another machine is mnning or not. 

rep rep local-filename other-machine-name : destination-filename 

Copy file from local-filename on your machine to the destination- 
filename on machine other-machine-name (use absolute pathnames 
for files). 

rep other-machine-name:filename local-filename 

Copy file filename from machine other-machine-name to local- 

filename (use absolute pathnames for files). 

rep -r local-directory-name other-machine-name: destination- 
directory-name 

With -r option, copy from local-directory-name on your machine 
to the destination-directory-name on machine other-machine-name. 

rep -r other-machine-name: directory-name local-directory-name 
With -r option, copy directory directory-name from machine 
other-machine-name to local-directory-name. 

rlogin rlogin machine-name [-1 username] 

Log in from your machine to the machine called machine-name 
using the current username; when you specify the -1 username 
option, rlogin attempts to log in with the username you specify. 

" aborts an rlogin connection. ~ followed by 
I Ctrl-Z) suspends an rlogin connection. 

r s h r sh machine-name command 

Execute command command on machine-name. 

rup rup [machine-name] 

Display system uptime and load average information for all 
machines on local Ethernet, or for machine specified. 
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rusers rusers [machine-name] 

Display usernames of users logged in on all machines of the local 
Ethernet, or for machine-name if specified. 

showmount 

showmount machine-name 

Displays which other machines have mounted filesystems on the 
machine machine-name. 

With the -a option, gives the filesystems on machine-name which 
have been mounted on other machines. 

telnet telnet [machine-name] 

File transfer program that includes commands: 

z z 

Suspend telnet program. 

quit quit 

Quit telnet. 

I Ctrl-11 obtains telnet prompt. 

tip tip phone-number 

Dial up phone-number and attempt to start a login connection. 

umount filesystem 

Unmount filesystem filesystem. 

options include: 

-h host Unmount all filesystems associated with the remote 

machine host. 

-a Unmount all filesystems in /etc/f stab. 

-V Report on each unmount as it occurs. 
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Glossary 


This glossary lists network facility terms in common use, especially in this 
manual. For commands, see the command summary. Appendix A . 

absolute pathname 

For a file or directory, the list of directories from the root directory through 
the tree structure to the desired filename or directory name, each name in the 
series separated by a forward slash character (/). 

background process 

A command that you have directed the system to work on while you con¬ 
tinue to type commands to the command interpreter. 

daemon 

A process that runs in the background, handling commands delivered for 
remote command execution. 

dialup connection 

A connection between machines through a phone line, 
distributed file system 

A file system that exists on more than one machine, permitting easy user 
access to files on other machines. 

establish a connection 

Initiate link for transfer of data between two machines, 
gateway 

A device that transfers data from one network to another — a link between 
networks. 

job number 

A number that the system assigns to each process running on that machine. 

local area network 

A network of machines in close proximity, connected by cables, 
modem 

A device that enables a machine or terminal to establish a connection and 
transfer data through telephone lines. 

mount point 

A directory on your system to which you mount a filesystem which exists on 
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a remote machine, 
mounting a file system 

Establishing a transparent link, using the Network File System, to a direc¬ 
tory on another machine so that the directory appears to be on the local 
machine, and can be accessed as such. 

network 

A connection between machines, allowing them to transmit information to 
one another. There are two general kinds of networks: local networks and 
remote networks. 

Network File System (NFS) 

A set of programs that permits users to directly access files on other 
machines, and the protocol which allows that access. 

network path 

A series of machine names used to direct mail from one user to another, 
protocol 

A “language” that networks use to communicate with each other— IP 
(internet protocol), TCP, and UDP are examples. 

read permission 

An attribute of a file that permits you to read and copy the file, 
remote network 

A network other than the local, cable-connected networic; it may contain a 
local network, however. 

remote command execution 

Typed instructions for a command to occur on another machine, and report 
back any output to the initial machine. 

remote shell 

A command interpreter that you initiate on one machine, but that executes 
on another machine specified on the command line. 

routing 

The process of determining a pathway for data to get from one machine in a 
network to another machine through a gateway. 

server 

1) A dedicated machine which provides files and network facilities to client 
machines; 2) Any machine which is providing files for a client machine 
(such a machine can be both a server and a client); 3) a daemon which actu¬ 
ally handles the providing of files. 

status information 

Information about the system, such as the system load averages, and how 
long since the last system downtime. 

suspend 

Stop a program so that one can type commands to the interpreter and later 
return to execution of the program. 
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terminal 

A process mnning on a machine that originates with the physical device 
called a terminal, or as a software representation of such a physical device, 
like a window. 

trust 

When a machine permits other machines and usernames access to accounts 
on that system without requiring a password or other security mechanisms. 

user information 

Information about users on a machine, such as usernames, time since log¬ 
ging in, and “terminal” number. 

window and mouse program 

A program that makes use of SunView, the window system and associated 
software, so that you can use the mouse to locate and select items within a 
window application on your screen. 

window-based tool 

See window and mouse program. 

write permission 

Access to a file that permits you to change the file. 

Yellow Pages 

A network database which includes information on users and machines on 
the network; also a service for looking things up in that database. 
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Defense Data Network, 6 
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workstation, 45 
directory copy, 38 
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error notification 

Address already in use.,42 
Connection refused, 42 
Connection timed out, 42 
Host name for your address unknown, 42 
Login incorrect, 42 
Network is unreachable, 42 
Permission denied, 42 
RPC_TIMED_OUT, 42 
unknown host, 42 
error notifications, 41 
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executing commands on another machine, 33,40 

F 
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.eshre, 40 
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/etc/hosts. equiv, 12 
file copy over network, 36, 37, 38 
file system, 5 
filesystem, 5 

filesystem options to mount, 27 
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G 
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H 

hard mounting, 27 
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Host name for your address unknown, 42 
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job number, 15, 18 
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LAN, 3 

load average, 34 
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local network, 5 

login access to other machines, 11 
Login incorrect, 42 

M 

MILNET, 6 
modem, 45 

modem connection, 46 
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mount point, 23 
creating, 23 

mounted directories, 36 
mounting remote filesystems, 5, 23 
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N 

network, 5 

ARPANET, 6 
common problems, 41 
copying directory, 38 
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internetwork protocol, 5 
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login over, 11 
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protocol, 5 
remote, 5, 6 

remote login, 11, 13, 16, 46 
UUCP, 6 

Network File System, 3, 36 
Network is unreachable, 42 
NFS, 3 

p 

perf meter command, 34, 52 
perimeter icon, 34 
Permission denied,42 
personal computer, dialup connection to, 45 
ping command, 33, 52 
protocol, 5 
TCP, 36 
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rep command, 37, 52 
-r option, 38, 52 
remote aliases, 40 
remote command execution, 33, 40 
remote daemon, 40 
remote file copy, 36, 37, 38 
remote load average, 34 
remote login, 11, 13,16, 46 
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call failed, 47 

different operating system, 16 
different username, 14 
no connection established, 47 
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problem, 13,14,17, 47 
suspending a connection, 15, 18 
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remote network, 5, 6 
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remote system uptime, 34 
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. rhosts file, 13 
rlogin command, 13, 52 
-1 option, 14, 52 
RPC__TIMED_OUT, 42 
rsh command, 40, 52 
rup command, 34, 52 
rusers command, 35, 53 

s 

server, definition of, 58, 4, 23 
showmount command, 29 
soft mounting, 27 
status information, 33 
Sun386i, 5, 6 
system information, 34 
system uptime, 34 

T 

TCP protocol, 36 
telnet command, 16, 53 
escape character, 17 
terminal, dialup connection to, 45 
tip command, 45,46, 53 
trust between machines, 11 

u 

umount command, 26 
unknown host,42 
unmounting remote filesystems, 26 
uptime command, 34 
user information, 35 
users command, 35 
UUCP, 6 
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w command, 35 
WAN, 3 

who command, 35 

wide area network, 3 

workstation, dialup connection to, 45 

Y 

Yellow Pages, 6, 12 
YP, see Yellow Pages 
ypbind, 7 
ypserv, 7 
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